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APPLICATION PROGRAMMING INTERFACE FOR ENABLING A 
DIGITAL TELEVISION RECEIVER TO ACCESS SYSTEM 
INFORMATION IN AN ABSTRACT FORMAT 

BACKGROUND OF THE INVENTION 

5 This application claims the benefit of U.S. 

Provisional Application Nos. 60/106,508, filed October 
30, 1998, 60/107,965, filed November 12, 1998, and 
60/113,444, filed December 23, 1998. 
The following acronyms are used: 

10 A/V - Audio/Video 

API - Application Programming Interface 
ATSC - Advanced Television Systems Committee 
BAT Bouquet Association Table (DVB) 
CA - Conditional Access 

15 CAT - Conditional Access Table (MPEG) 

CNN - Cable News Network 
DAVIC - Digital Audio-Video Council 
DCII - GI Digicipher II (tm) 
DIT - Data Information Table 

20 DTV - Digital Television 

DVB - Digital Video Broadcasting 

DVS - Digital Video Standard 

EIT - Event Information Table (DVB/ATSC) 

EMM - Entitlement Management Message 

25 EPG - Electronic Program Guide 

ETT - Extended Text Table (ATSC) 
FCC - Federal Communications Commission 
GIC - General Instrument Corporation 
GPS - Global Positioning Satellite 

30 ID - Identifier 
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IP - Internet Protocol 

JMF - Java Media Framework (Sun Microsystems) 
MGT - Master Guide Table (ATSC) 
MPAA - Motion Picture Association of America 
5 MPEG - Moving Pictures Expert Group 

MSP - Message Stream Protocol 
NIT - Network Information Table (DVB) 
NVOD - Near Video -On -Demand 
PID - Packet Identifier 
10 PMT - Program Map Table 

PSI - Program Specific Information 
PSIP - Program and System Information Protocol 
(ATSC) 

RRT - Rating Region Table (ATSC) 
15 SCTE - Society of Cable Television Engineers 

SDT - Service Description Table (DVB) 

SI - System Information 

STT - System Time Table 

TDT - Time Date Table (DVB) 
20 TOT - Time Offset Table (DVB) 

TS - Transport Stream 

TSDT - Transport Stream Descriptor Table (MPEG) 
UML - Unified Modeling Language 
URL - Uniform Resource Locator 
25 VCT - Virtual Channel Table 

VSB - Vestigial Side Band 



The present invention provides an API for 
accessing Program and System Information that describes 
the layout and content of an MPEG- 2 TS. This 
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information, also known as service information, is 
generally called System Information (SI) . 

There are different formats of SI used and 
standardized today. These include the original ATSC 
5 A56 standard, which is a subset of the DigiCipher II 
(DCII) MSP, used for both satellite and cable 
television transmission, and the new ATSC PSIP for 
terrestrial and cable DTV, Cable SI such as DVS (SCTE 
DVS 234: Service Information Carried Out-Of-Band For 

10 Digital Cable Television), and the DVB SI standard. 

Private data, such as that in the DigiCipher II 
standard that is proprietary to GIC, the assignee of 
the present invention, may also be used. 

The ATSC standard is described in "Program and 

15 System Information Protocol for Terrestrial Broadcast 

and Cable, « Doc. A/65, 23 Dec 1997, available from the 
ATSC. The DVB standard is described in "Digital Video 
Broadcasting (DVB) ; Specification for Service 
Information (SI) in DVB systems," EN 300 468 vl.3.1 

20 (1998-02), available from the European Broadcasting 

Union or the European Telecommunications Standards 
Institute. 

Subscriber terminals receive the SI via a network. 
A set- top terminal, also referred to as an Integrated 

25 Receiver-Decoder (IRD) or a subscriber . terminal, is a 

device that receives and decodes television signals for 
presentation by a television. The signals can be 
delivered over a satellite, through a cable plant, or 
by means of terrestrial broadcast, for example. 

3 0 Various applications have been proposed, or are 

currently available, via modern set tops, including 
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video on demand (VOD) , audio on demand, pay-per-view, 
interactive shopping, electronic commerce, electronic 
program guides, Internet browsers, mail services (e.g., 
text e-mail, voice mail, audio mail, and/or video 
5 mail) , telephony services, stock ticker, weather data, 
travel information, games, gambling, banking, shopping, 
voting, and others. Applications may also enable 
Internet connectivity and possibly Internet-based 
telephony. The set top functionality is enabled 

10 through specialized hardware and software. 

The applications may be downloaded by terminals 
via a network, loaded locally (e.g., via a smart card), 
or installed at the time of manufacture, for example. 

However, the subscriber terminal that receives the 

15 SI must known which format is being used, and provide 

corresponding processing that is specific to that 
protocol. This is problematic since it forces the 
development of special code (software) at the terminal 
for accessing the SI. Thus, the cost, complexity, and 

2 0 computational requirements of the terminals are 

increased, and the development of software for the 
terminal is impaired. 

The above problems are highlighted by the trend 
toward integration broadband distribution networks, 

25 telephony networks, and computer networks such as the 

Internet and in-home networks, and by the desire to 
enable new types of applications that provide a 
feature- rich experience for the viewer. 

Accordingly, it would be desirable to provide a 

30 system for accessing SI in a digital transport or other 
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data stream that is compatible with different SI 
formats . 

The system should abstract common elements of the 
SI from the different formats to provide "abstract SI." 
The "abstract SI" should provide access to SI that is 
useful to an application at such a level of abstraction 
that the application does not have to be aware of what 
SI standard format is used to deliver the information 
to the receiver. 

The system should avoid the need for the 
application to have special code (software) when it is 
intended to run in different environments, such as DVB, 
SCTE and ATSC-based systems. 

The system should be suitable for use with SI that 
is provided using different formats, including MPEG 
Program Specific Information (PSI) , Digital Video 
Broadcasting Service Information (DVB SI) , Advanced 
Television Systems Committee Program and System 
Information Protocol (ATSC PSIP) , Cable SI such as DVS, 
and private SI, such as those in the DCII system. 

The system should allow different applications to 
retrieve only the specific SI they require. 

The system should allow an application to retrieve 
a specific descriptor from the SI if needed. 

A descriptor refers to a mechanism for extending 
table data. Generally, the various digital video 
standards allows the use of various types of tables of 
data for carrying SI. For example, a table may 
designate locations in a TS (e.g., PID, frequency) at 
which a particular channel or program is carried. 
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Moreover, since tables are fixed structures that 
are difficult to extend over time to accommodate 
additional information, descriptors have been developed 
as an extension mechanism. A descriptor can be 
5 appended in an outer loop or inner loop of the table. 

In an outer loop, the descriptor is appended at the end 
of the table and provides additional table entries each 
time the entire table is read. In an inner loop, the 
descriptor is appended at the end of a portion of the 
10 table and provides additional table entries each time 

that of the table is read. 

A descriptor may comprise a tag followed by a 
field or string of information, for instance. 

Descriptors are only included as needed, and do 
15 not interfere with receivers that have not been updated 
to recognize them. 

Additionally, the system should make use of URL 
syntax concepts that are currently being defined for 
DTV. 

20 The system should be implementable in an API at a 

subscriber terminal in a television network. 

The API should be compatible with Java(tm), 
ActiveX (tm) or an equivalent type of component -based 
object-oriented technology. 

25 The system should optionally provide asynchronous 

delivery of results, separation of MPEG-2 specific data 
from a TS, and incremental retrieval of SI data. 

The system should be compatible with a URL locator 
syntax. Note that a URL definition for DTV is still 

30 being established. The current API definition supports 
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the DAVIC DVB URL and the GlC-proposed DTV and ATSC 
URLs . 

The present invention provides a system having the 
above and other advantages . 
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SUMMARY OF THE INVENTION 

The present invention provides an API that allows 
applications that are running on a digital television 
terminal to recover SI from a digital TS without regard 
5 to the specific format type. The API abstracts the 

relevant portions of the SI to provide it in a format 
that is usable by different applications at the 
terminal . 

Additionally, a Descriptor sub-package described 

10 below allows an application to retrieve a specific DVB 
or ATSC or private (e.g., DCII) descriptor if it has a 
special need to do so. 

This SI API definition further employs the URL 
concept that is well known in connection with Internet 

15 and browser applications. A formal URL definition for 

DTV is still under discussion. The current API 
definition supports the DAVIC DVB URL and the General 
Instrument Corporation (GI) proposed DTV and ATSC URLs. 
A television set-top terminal in accordance with 

20 the invention includes a computer readable medium 

(e.g., such as a magnetic or optical storage device) 
having computer program code means (e.g., object- 
oriented code such as Java(tm)), and means for 
executing (e.g., any processor such as- a CPU) the 

25 computer program code means to implement an Application 

Programming Interface (API) . 

The API is adapted to abstract SI in a digital 
television transport stream that is received by the 
terminal in any one of a plurality of different 

30 formats. The API provides the abstracted SI in a 
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generic format that is suitable for use by an 
application at the terminal regardless of the specific 
format in which the SI is provided. For example, the 
different SI formats may include different data table 
5 formats . 

This allows a terminal to be compatible with a 
number of different data stream formats. 

Moreover, the API may provide a number of 
functions at the terminal that are responsive to the 

10 abstracted SI, such as a navigation function that 
allows the terminal to navigate among television 
channels in the transport stream, a program guide 
function that implements an electronic program guide 
for the television channels, a selection function that 

15 selects specific television channels, and a descriptor 

retrieval function for recovering descriptors of the 
SI. 

Additionally, the API provides a utility function 
containing supporting objects, including events and 

20 exceptions, for supporting the delivery of the SI to 

the application synchronously, a data function for 
implementing a guide to data services in the transport 
stream in accordance with the abstracted SI, and a 
pipeline function for providing information regarding a 

25 physical delivery mechanism (e.g., satellite or 

transponder identifier) of the transport stream. The 
pipeline function uses the appropriate SI tables to 
provide information about the delivery network (MPEG- 2 
Transport Stream, etc J. 

30 The API provides these functions by exposing the 

appropriate SI data to the application. An application 



10 



such as an EPG can use these APIs to do its job, e.g. 
an EPG uses the Navigation package (or function) to 
learn about channels, and it uses the Guide package 
(function) to learn about scheduled programs on the 
5 selected channels. Thus, the APIs or packages 

discussed herein are used (called) by specific 
applications . 

The different available SI formats can include: 
Motion Picture Experts Group (MPEG) Program Specific 

10 Information (PSI) , Digital Video Broadcasting (DVB) 

System Information (SI) , Advanced Television Systems 
Committee (ATSC) Program and System Information 
Protocol (PSIP) , Cable SI Digital Video Standard 234 of 
the Society of Cable and Television Engineers, and 

15 private SI. 

The terminal may include a memory for storing the 
SI as the transport stream is received at the terminal, 
where the API provides a retrieve function call for 
enabling a calling application to retrieve the SI such 

20 that SI that is available in the memory is returned 

essentially immediately as a direct return value. If 
the service information is not available in the memory, 
the retrieve function call returns an exception 
signaling to the calling application that the SI is to 

25 be delivered to the calling application asynchronously. 

In this case, the API may also provides a utility 
function containing supporting objects, including 
events and exceptions, for supporting the asynchronous 
delivery of the SI to the calling application. 

30 Moreover, when the transport stream is provided in 

one of a plurality of available transport stream 
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formats, the API may abstract the SI to provide it in a 
generic format that is suitable for use by an 
application at the terminal. This may be achieved by 
providing a base package having information that is 
5 generic to the available transport stream formats. The 
API is adapted for use with a separate package having 
information that is specific to the format of the 
received transport stream. 

Generally, the API provides the base set of APIs, 

10 which is extensible. For instance, ATSC is adding new 

packages to provide PSIP specific info, and DVB may do 
the same. Such packages are not shown here. However, 
the API of the present invention is extensible so that 
format-specific extensions can be easily made by 

15 subclassing or extending the Abstract SI API classes 

and interfaces . 

In a further aspect of the invention, the API 
provides incremental retrieval of the service 
information by allowing a calling application at the 

20 terminal to obtain a subset of the SI that is available 

at the terminal, perform an analysis of the obtained 
SI, and retrieve additional SI if required based on the 
analysis. The additional SI may be retrieved from the 
subset of the SI that is available at the terminal in a 

25 memory of the terminal, or from the transport stream. 

Note that the SI data may be stored at the 
terminal using a variety of implementations. For 
example, it can be stored before and/or after 
abstracting, after optimizing and compression, and so 

30 forth. 
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The API enables a calling application at the 
terminal to recover a subset of the SI in the transport 
stream while rejecting other SI in the transport stream 
that is not required by the calling application. 
5 The API may also provide a filtering function that 

is responsive to the abstracted SI to allow the 
application to specify at least one service in the 
transport stream in which the application is 
interested. The filtering can be based on whether the 

10 services are associated with: a particular transport 

stream (when services from multiple transport streams 
are available - a receiver may have multiple tuners, or 
SI data may be stored in the receiver's memory, in a SI 
database, that is collected from multiple transport 

15 streams over time), a network, a bouquet, a satellite, 

a satellite transponder, a service name, a 
service/ channel number, a favorite channel, and a 
theme . 

Moreover, the API may be implemented using a 
20 plurality of packages for abstracting the SI, in which 

case it is efficient for the different applications at 
the terminal to include only specific ones of the 
packages according to specific portions of the 
abstracted SI that each application requires. 
25 A corresponding method is also presented. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 shows package relationships and 
dependencies of an API in accordance with the present 
invention. 

5 FIG. 2 illustrates a navigation package 

class/interface diagram in accordance with the present 
invention. 

FIG. 3 illustrates a program guide package 
class/interface diagram in accordance with the present 
10 invention. 

FIG. 4 illustrates a selection package 
class/interface diagram in accordance with the present 
invention. 

FIG. 5 illustrates a descriptor package 
15 class/interface diagram in accordance with the present 

invention. 

FIG. 6 illustrates a pipeline package 
class/interface diagram in accordance with the present 
invention . 

20 FIG. 7 illustrates a data package class/interface 

diagram in accordance with the present invention. 

FIG. 8 illustrates a utility package 
class/interface diagram in accordance with the present 
invention. 
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DETAILED DESCRIPTION OF THE INVENTION 

An API allows applications that are running on a 
digital television terminal to recover SI from a 
digital TS without regard to the specific format type. 

5 The API abstracts the relevant portions of the SI to 
provide it in a format that is usable by different 
applications at the terminal. 

The API is preferably independent of an operating 
system and hardware of the terminal. 

0 Note that the figures were generated automatically 

from Rational Rose(tm) CASE tool, developed by Rational 
Software Corporation, USA. The figures use the 
Rational Rose (tm) depiction of the UML, which is a 
language for specifying, constructing, visualizing, and 

5 documenting the artifacts of a software-intensive 

system. A class diagram represents the static 
structure of a system, and shows a pattern of behaviors 
that the system exhibits. This is accomplished by 
showing the existence of classes and their 

0 relationships. Each class is represented by a box with 

three sections. The top section lists the class name. 
The middle section denotes a list of attributes, and 
the bottom section denotes a list of operations. 

A solid or dashed line between classes denotes an 

5 association or dependency. A white diamond tip denotes 

aggregation by reference, while a black diamond tip 
denotes aggregation by value. A triangular arrowhead 
denotes a restricted navigation, e.g., inheritance of 
operation but not of structure. 
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Moreover, interfaces and classes begin with an 
uppercase letter, while methods begin with a lowercase 
letter. 

A class is a template that defines a data 
5 structure, method and function calls for an object. An 
interface defines a set of methods/function calls that 
can be manipulated by a class. The class provides the 
code for implementing an interface. 

1. Model Description 

10 The entire SI database model is based on the 

concept of "views". There are different ways to look 
at the SI database, and different applications may have 
different needs. The specified views allow 
applications to be concerned only with a subset of the 

15 SI database based on the application's needs. The 
concept of views is represented by Java packages. 

The following sections describe the object model 
of the Abstract SI API. 

FIG. 1 is a high-level figure that shows package 

20 relationships and dependencies of an API in accordance 
with the present invention. 

The Navigation package 110 contains the main set 
of classes and interfaces that are used to navigate the 
existing television channels (DVB Services or ATSC 

25 Virtual Channels) . The Selection package 130 adds 

features which allow a TvChannel to be used for tuning 
and selection of specific services (MPEG programs) . 
The Guide package 120 provides information useful for 
an EPG, including program schedules, individual program 

30 events and program ratings. The Descriptor package 140 
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allows a retrieval of individual MPEG descriptors 
associated with the MPEG sections that deliver the SI. 
The Pipeline package 170 isolates some of the specific 
delivery media information. The classes provided in 
5 this package currently represent the MPEG- 2 delivery 

mechanism. The Data package 160 is similar to the 
Guide package 12 0 except it provides information about 
data-related events (services), e.g., any software 
application that is sent along with the audio/video 

10 stream, such as a stock ticker, news ticker, sports 

statistics, interactive commercial, etc.), not 
audio/video events. Lastly, the Util (Utility) package 
150 contains objects of a supporting nature, such as 
events, exceptions, etc. 

!5 This model provides both a high-level abstraction 

of the SI that describe the layout of the content 
delivered over the multiplex (meta-data) , as well as 
detailed information specific to a particular SI 
format. This is done via access to MPEG table 

20 descriptors. Since descriptors are used as way to 

extend the SI for additional and future functionality, 
it is a significant advantage of the invention that the 
API provides a generic access to the descriptors 
without changing the implementation of the API with 

25 every new or changed descriptor. 

In one aspect of the invention, asynchronous 
delivery of results is provided. Since there are DTV 
receivers with varying capabilities, it is expected 
that not every receiver will cache all the SI data in 

30 the memory. It will do so for the necessary subset of 
the most useful information, but will have to parse the 
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actual TS when it needs to retrieve data not stored in 
memory. However, access to the TS may take a 
significant amount of time. Therefore the API provides 
an asynchronous access to information that is not 

5 expected to be in memory at all times. In general, 

asynchronous (or non-blocking) calls add complexity not 
only to the implementation of the API but to the 
application using the API as well. 

To hide the difference between low-end and high- 

0 end receivers, this API provides a single method which 

can be completed synchronously, if the information is 
available locally (in memory) , or asynchronously, if 
the data have to be retrieved from the TS . All API 
calls starting with "retrieve" either return the 

5 requested object or throw an exception indicating that 

the data will be delivered later via an asynchronous 
event. The caller can register itself as an listener 
to this event. Or, by not registering, the caller can 
indicate that it is interested in synchronous data 

0 delivery only. The exception includes enough 

information to cancel the request and to associate it 
with the actual event delivering the data. 

The SI usually contains system time related 
information in the form of the PS IP STT message or DVB 

5 TDT and TOT messages. At this time it is assumed that 
the local DTV receiver time will be synchronized with 
the system time of the channel currently tuned to and 
the value can be obtained using the java.util .Date 
class. Note that this is acceptable if all transport 

0 multiplexes use a reliable and synchronized data source 
(such as GPS) . If a certain multiplex provides 



18 



erroneous time information, it is up to the receiver 
implementation to resolve the situation. 

1.1 Navigation View 

FIG. 2 illustrates a navigation package 
5 class/interface diagram in accordance with the present 

invention. 

Like-numbered elements correspond to one another 
in the figures . 

The Navigation package 110 has two main functions, 
10 namely: 

(1) give access to all or a selected subset of 
TvChannels, which represent DVB services and ATSC 
virtual channels; and 

(2) give access to network related information 
15 such as the network definition, satellite and 

transponder information, TS and bouquet information, 
etc . 

Like-numbered elements correspond to one another 
in the figures. 

20 The package includes the following classes and 

interfaces: CAIdentif ication 205, DeliverySystemType 
807, SystemlnformationType 810, ChannelCollection 220, 
TvChannel 225, SlUpdate 830, ChannelConstraint 235, 
SIManager 240, TvChannelDetails 245, and 

25 Channel I dent if ication 250. 

The main navigation function is represented by the 
following classes and interfaces. The SIManager 240 is 
the primary access point to the underlying SI database. 
It can generate a collection of TvChannels 225 called 

30 ChannelCollection 220 based on the selection criteria 
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represented by the ChannelConstraint 235 object. The 
selection criterion may be a network ID, TS ID, bouquet 
ID, user favorite channels, URL, etc. The collection 
can then be used to sort either by channel numbers or 
5 by channel names and navigate through the TvChannels 
225 which represent either a DVB Service or an ATSC 
Virtual Channel . 

The TvChannel 225 itself contains only the minimal 
information (such as Locator, Channel name and number) 

10 needed to navigate. Additional information about the 

channel is contained in the TvChannelDetails object 
245. The TvChannelDetails also provides some CA- 
related information via the CAIdentif ication interface 
205, a delivery mechanism, and the time when the 

15 information about this channel was last updated. The 

channel name and number is actually encapsulated in the 
Channel Identif ication object 250, which can be extended 
to accommodate different mechanisms for naming and 
numbering channels, such as the ATSC two-part channel 

20 number (e.g., using a major. minor notation - a string 

with a dot between the major and minor channel numbers 
- ex: 10 .2) . 

1.2 Guide View 

FIG. 3 illustrates a program guide package 
25 class/interface diagram in accordance with the present 

invention. 

The package includes the following interfaces: 
SIManager 240, TvChannelDetails 245, 

TvChannelWithSchedule 300, ContentRatingAdvisory 310, 
30 Programs chedule 320, RatingRegion 330, ProgramEvent 
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340, RatingDimension 350 and SlUpdate 830 (defined in 
FIG. 8) . 

This package is intended to support electronic 
program guide type applications. It provides the 
5 application with two related sets of information: the 
program schedule on each channel; and rating 
information. The Programs chedule object 32 0 can be 
used to retrieve the currently-playing program, the 
immediately following one, and then any other available 

10 program in the future for a specified time period. 

Each ProgramEvent 340 can be queried for its name, 
start time and end time, description, rating, cost and 
other related information. 

Rating related information is organized into 

15 rating regions, where each region may have a multiple 

rating dimensions such as MPAA rating, FCC TV rating, 
DVB age-based rating, etc. Each dimension contains 
multiple levels; each ProgramEvent is labeled with one 
of these levels for all supported rating regions. 

20 1.3 Selection View 

FIG. 4 illustrates a selection/tuning package 
class/interface diagram in accordance with the present 
invention. 

The package includes the following classes and 
25 interfaces: TvChannelDe tails 245, Channel Component 

410, MPEGChannelComponent 420, Locator 43 0, MPEGLocator 
440 and ATSCLocator 450. 

The tuning package extends the navigation 
functionality primarily by adding information about 
30 individual components of each TvChannel, such as video, 
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possibly multiple audio components and optional data 
components. The TvChannel object 225 can provide a 
Locator used by a TV Player which follows the JMF 
Player model or a separate service selection API. 
5 The generic Channel Component 410 is extended in by 

* the MPEGChannelComponent 420, which represents MPEG- 
specific information. 

The basic Locator 43 0 concept is extended to 
support the MPEG-specific Locator (MPEGLocator 440) , 
10 which is then specialized for ATSC (ATSCLocator 450) . 
Note that the DAVIC package includes a DVB- specific 
subclass as well. 

1.4 Descriptor View 

FIG. 5 illustrates a descriptor package 
15 class/interface diagram in accordance with the present 

invention. 

The package includes the following interfaces: 
TableType 510, DescriptorTag 520, Descriptor 53 0, 
MPEGTableDescriptors 540 .and MPEGPipeline 660 (defined 

20 in FIG. 6) . 

Descriptors are generally delivered in MPEG- 2 
tables in two locations: the outer loop which 
associates descriptors with the entire table, and the 
inner loop which associates descriptors with the 

25 specific entity described in the inner' loop. An 

example is a PSIP VCT, which has both outer- and inner- 
loop descriptors. The outer loop descriptors are 
associated with all virtual channels defined by this 
VCT, while each inner loop contains descriptors for a 

30 specific virtual channel. 
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Applications executing on a set-top will use APIs 
to access the set-top functions including the SI. The 
goal is to provide a format -independent API to retrieve 
SI (ATSC PSIP, DVB SI, etc.) to minimize the 
5 application's required knowledge of the details of 

these SI formats. Abstraction is good in most cases, 
but certain applications need access to a specific 
descriptor which is not provided at the abstract API 
level. For example, this can be a descriptor which 

10 will be defined in the future. Therefore, it cannot be 
represented in the API directly. It can also be one of 
the descriptors that are not intended for an 
application; they are rather used by the receiver 
itself (e.g., AC 3 descriptor, Linkage descriptor, etc.) 

15 The problem is to specify the specific descriptors 

an application is interested in. This applies to both 
determining the appropriate table, as well as the 
position of the descriptor loop. 

The type of information (e.g., TS, service, event, 

20 etc.) for which descriptors are to be retrieved is 

primarily identified by a DTV URL. There are some rare 
exceptions; e.g., the DVB BAT is really not identified 
by any current URL formats. The DTV URL is usually 
sufficient to point to a specific <table__type, 

25 descriptor loop> pair, especially for URLs pointing to 

an event or an elementary stream. 

There are several cases where the URL is not 
specific enough because an entity, a service for 
instance, may be described in multiple tables, such as 

3 0 PMT and DVB SDT. Therefore, a table_type is specified 

to identify which type of a table to retrieve 
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descriptors from. Table_id is not used since some 
table types have different table_ids within the type 
(e.g., DVB NIT has 0x40 and 0x41). The table_type 
scopes down the range of tables to search for 
5 descriptor especially at the higher level of URLs (the 
service and TS levels) . 

In some rare cases, an additional identification 
is needed. For instance, if a rating_type is 
specified, a Rating Region ID is needed to retrieve the 

10 proper subset of descriptors from the ATSC RRT. The 

same applies to navigation_type tables where a Eouquet 
ID is needed to retrieve descriptors from the DVB BAT 
outer descriptor loop. 

Additionally an optional set of descriptor tags 

15 can be specified in the call to limit the search and 

the returned set of descriptors to the descriptors 
hinted in the list. If a set of descriptors is found 
in the given table identified by the <url, table_type, 
entity_info> tuple (e.g., set of values), only those 

20 matching the descriptor tags provided in the hint will 

be returned. 

Note that all descriptor retrieval methods support 
both synchronous as well as asynchronous data delivery 
depending on the caching capability of the DTV 
25 receiver. 

1.5 Pipeline View 

In an optional embodiment, separation of MPEG-2 
specific data is provided. 

Digital television content is primarily delivered 
30 using the MPEG-2 transport format. This is true for 
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DVB as well as ATSC. With the convergence of 
television and personal computers, it is expected that 
digital video content may be delivered to the 
television receiver by other means, such as over the 
5 Internet in an IP format with some kind of a real-time 
protocol. This motivates a higher level of abstraction 
for the SI API that hides not only the difference 
between ATSC PS IP and DVB SI (both extensions of MPEG- 
2) , but also the difference between the different ways 

10 of delivering the content and the SI. 

This design removes all MPEG-2 (e.g., TS) specific 
information into a separate package. A base class, 
which provides generic transport -neutral information, 
can be further extended with MPEG-2 specific 

15 information for MPEG-2 delivery networks. As new 

delivery mechanisms become popular, the base classes 
can be extended to provide detailed information about 
the specific protocol. 

Essentially, the API further abstracts the SI to 

20 provide it in a manner that is independent of the 

specific TS formats. The API can therefore run on a 
terminal that receives a TS in any one of a number of 
different available formats. 

FIG. 6 illustrates a pipeline package 

25 class/interface diagram in accordance with the present 

invention. 

The package includes the following classes and 
interfaces: SIManager 240, Satellitelnf ormation 605, 
Networklnf ormation 610, Bouquet Information 63 0, 
30 SISpecif icManager 640, Pipelinelnf ormation 650, 
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TransportStreamlnfo 660, MPEGPipeline 670 and 
Systemlnf ormationType 810 (defined in FIG. 8) . 

The Pipeline package provides additional 
information about the physical mechanism media 
5 delivering the content the SI data describes. The 
physical delivery mechanism can include, e.g., 
satellite/ transponder information. SISpecif icManager 
640 provides access to the abstract Pipelinelnf ormation 
650, which in this particular case is extended by the 
10 MPEGPipeline 670 representing an MPEG-2 multiplex. The 

generic Pipelinelnf ormation 650 can be extended to 
support other types of delivery of content (e.g., 
Internet Protocols) . 

1 . 6 Data View 

15 FIG. 7 illustrates a data package class/interface 

diagram in accordance with the present invention. 

The package includes the following interfaces: 
TvChannelDetails 245, ContentRatingAdvisory 310, 
TvChannelWithData 710, DataSchedule 72 0, DataEvent 73 0 

20 and SlUpdate 830 (defined in FIG. 8) 

The Data view is similar to the Guide view, which 
represents EPG-like information. In this case, the 
data schedule represents a lineup or guide of data 
events as opposed to audio/video events. 

25 Note that this package is modeled'' after the ATSC 

T3/S13 work, which is still in progress. 



1.7 Utility View 
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FIG. 8 illustrates a utility package 
class/interface diagram in accordance with the present 
invention. 

The package includes the following classes and 
5 interfaces: SIFactory 805, SIManager 240, 

Systemlnf ormationType 810, SIChangeListener 815, 
EventObject 82 0, SlUpdate 83 0, SIChangeEventType 832, 
SIChangeEvent 834, TvChannelChangeEvent 835, 
DataChangeEvent 840, ProgramChangeEvent 845, 

10 Sllnf oChangeEvent 85 0, Exception 8 60 (from the 

java.lang package), SIRetrievalEvenc 865, 
SIRetrievalListener 870 , SIDelayedDeliveryException 
875, SIException 880, SIRetrievalFailEvent 882, 
SIRetrievalSuccessEvent 884, SIRequest 886, 

15 SINotAvailableException 890, 

SIRetrievalSingleSuccessEvent 892 and 
SIRetrievalMultipleSuccessEvent 894 . 

The utility package provides support in several 
areas, namely: 

20 1. the event notification mechanism for both SI 

entity changes detected in the TS and events delivering 
asynchronous requests; 

2. the SI Factory which creates SI Manager (s) ; and 

3 . exceptions . 

25 The SIChangeListener 815 and the SIChangeEvent 834 

support the standard Java event model." The are three 
types of objects to listen to for changes: 

1. The SIManager 240, which reports changes 
detected in the Network definition related tables 

3 0 represented by the TransportStreamlnf o 660, 
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Networklnf ormation 610, Bouguetlnf ormation 630, etc. 
objects . 

2. The ChannelCollection 220, which reports 
changes detected in any one of the TvChannels 225 
5 contained by the collection. 

3 . The Programs chedule 320, which reports changes 
detected in any one of the ProgramEvents 340 in the 
schedule . 

Applications can register as listeners with the 

10 above-listed objects, and they will be notified by 

receiving one of the three appropriate events, which 
will deliver the details about which specific object 
has changed. To obtain the new information, the 
application needs to regenerate the particular 

15 collection of objects (ChannelCollection 220, 

Programs chedule 320, etc.). 

Note that it may be difficult to implement the 
above defined events unless the receiver does a field- 
by- field comparison of old and new tables of the same 

20 type. The receiver may choose to deliver only the 

high-level event and let the application update 
multiple objects if necessary. 

The Utility package 150 also provides the 
mechanism to deliver data asynchronously. This 

25 functionality is provided by the SIRequest 886, 

SIDelayedDeliveryException 875, SIRetrievalEvent 865 
and SIRetrievalListener 870. The 

SIDelayedDeliveryException 875 signals to the caller 
that the data is available only asynchronously and 
30 provides the SIRequest object 886 which can be used to 

cancel the request and to associate this request with 
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the SIRetrievalEvent 865, which eventually delivers the 
requested data or an indication of a failure. The 
caller of the asynchronous method (indicated by the 
"retrieveXXX" name) may register as a listener to get 
5 the event. If it decides not to register as a 

listener, it is an indication to the API implementation 
that there is no need to parse the TS and retrieve the 
requested data. Thus, in accordance with the present 
invention, the application has complete control over 

10 the delivery of data. 

Thus, incremental retrieval of SI data can be 
provided. Generally, there is a wide variety of 
applications that will execute on DTV receivers. Some 
of the receivers need access to the full SI data set 

15 (such as EPG-like applications), while others may need 

only a very small subset of the SI data. To support 
all of these applications without putting an extra 
burden on those needing a small subset of the SI data, 
the present invention enables incremental retrieval of 

20 SI data. This allows an application to obtain a small 

set of SI data, "make an intelligent decision, and 
retrieve more SI for possibly a selected SI object or a 
subset of SI objects. 

Such a design provides flexibility, more control 

25 to the application, and more efficient retrieval of SI 

data. 

Since most of the SI objects are really interfaces 
which don't have constructors, an application does not 
have a way to instantiate an object that implements the 
30 specified interface. To get an instance of the object 

that implements the SIManager interface 240, an 
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SIFactory class 805 is provided which has a method to 
obtain an instance of the SIManager. 

Several methods throw Exceptions to report invalid 
parameters or other types of error conditions (see 
5 classes 875 and 880) . 



2.0 Class and Interface Description 

2.1 Navigation Package (FIG. 2) 

This view at the SI is from the point of view of a 
navigation mechanism, such as a simple channel guide, 
10 channelUp and channelDown buttons , etc. 

It provides enough information to present a list 
of available MPEG2 services with a filtering mechanism. 



2.1.1 TvChannel 225 

TvChannel represents an abstract view on what is 
15 referred to as an MPEG Program, DVB Service or an ATSC 

Virtual Channel. It represents the common information 
associated with it, such as channel name, channel 
number, description, etc. Each TvChannel is uniquely 
identified by a tuple including system type, network 
20 id, TS ID, service number or channel number. This 

identification may be represented in the URL format. 
Public Operations: 
getLocator () : Locator 

Returns the complete Locator of this TvChannel. 
25 getLongChannelName () : String 

Returns a full channel name. 
isHidden () : boolean 

Returns TRUE is this is a hidden channel. 
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retrieveDetails (listener : 
org.atsc.abstractSI.util.SIRetrievalListener) : 
org • atsc . abstracts I .navigation . TvChannelDetails 

This method retrieves additional information about 
5 the TvChannel . This information is based on the SI 
data (also called meta-data) . SI data can be 
considered to be information about other data (content) 
such as audio/video/data components of the transport 
stream. Since it is data about other data, it is 
10 sometimes called meta-data. 

This method may return data synchronously or 
asynchronously . 

getldentif ication () : 
org . atsc . abs tractSI . navigation . Channelldentif ication 
15 This method is used to obtain the channel 

identification (e.g., channel name and number). 

2.1.2 ChannelCollection 220 

ChannelCollection represents a collection of 
TVChannels 225 based on a specific grouping rule 
20 defined by the ChannelConstraint association class 235. 

Filtering used to create such a collection may be based 
on TS ID, Network ID, System Type (DVB, ATSC, etc.), 
Bouquet, content theme (e.g., sports), Channel name or 
a subset of it (e.g., CNN) or possibly a combination of 
25 these. 

This class also provides a mechanism for browsing 
those TVChannels contained by the particular collection 
instance . 

This is similar to the SortedMap interface (from 
30 Sun Microsystem's JDK 1.2 APIs) but provides only a 
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small subset of the functionality as applicable to this 
domain. 

Public Attributes: 

SORT_BY_CHANNEL_NUMBER : short = 1 
5 SORT_BY_NAME : short = 2 

Public Operations: 
size () : int 

Returns the number of TvChannels contained in this 
collection. 

10 sort (criterion : short) : void 

Called to specify an algorithm for determining the 
behavior of the nextChannel and previousChannel 
methods . 

For example, if sorting by channel name is 
15 specified, the nextChannel method will return the next 

TvChannel object with a name alphabetically following 
the current TvChannel . It is always sorted in an 
ascending order. 

nextChannel (currentChannel : 
2 0 org * atsc ♦ abs tracts I . navigation * TvChannel ) : TvChannel 

Returns the next TvChannel relative to the 
specified TvChannel based on the sorting criterion. 
Null is returned if end of collection is reached. 
previousChannel (currentChamxel : 
25 org.atsc.abstractSI. na v igation.TvChannel) : TvChanne 1 

Returns the previous TvChannel based on the 
sorting criterion. Null is returned if the beginning 
of this collection is reached. 

firstChannel () : TvChannel 

30 Returns the first TvChannel in this collection 

based on the sorting criterion set for this collection. 
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lastChannel () : TvChannel 

Returns the last TvChannel in this collection 
based on the sorting criterion set for this collection. 
addListener (listener : SIChangeListener) : void 

5 Called to register an SIChangeListener 815 for 

changes related to the Channels in this collection. A 
TvChannel ChangeEvent 83 5 will be delivered to the 
listener . 

removeListener (listener : SIChangeListener) : 

10 void 

Called to deregister a SIChangeListener for 
changes related to the Channels in this collection. 

retrieveChannels (filter : 
org ♦ a ts c . abs trac tSI . navigation . ChannelCons train t , 
15 listener : 

org.atsc.abstractSI .util ♦ SIRetrievalListener) : 
ChannelCollection 

This method returns a ChannelCollection object 
220, which is a subset of this collection, based on the 

2 0 grouping conditions specified in the filter parameter. 

If the filter is null, a collection of all TvChannels 
225 contained in this collection is returned. 

This method is provided to generate an 
increasingly specialized collections of TvChannels 
25 based on multiple filtering (grouping) criteria, 

findChannel (locator : org.davic.net .Locator) : 
org . atsc . abs trac tSI . navigation . TvChannel 

This method returns the TvChannel corresponding to 
the specified locator if it is a member of this 

3 0 collection. Otherwise, it returns null. 
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f indChaimel (channel ID : 
org . atsc . abs tractSI .navigation . Channel Ident if ication) : 
org . ats c . abs tracts I . navigation . TvChannel 

This method returns the TvChannel corresponding to 
5 the specified channel identification if it is a member 
of this collection. Otherwise; it returns null. 

2.1.3 SIManager 240 

SI Manager represents the central managing entity 
which has a knowledge of the entire network or a 
10 collection of networks, and can create a collection of 

TvChannels based on the ChannelConstraint filtering 
rules . 

It has also access to specific SI representations 
of each individual TS (DVB SIDatabase, ATSC 
15 PSIPDatabase, etc.) 

Public Operations: 

retrieveChannels (filter : 
org . atsc . abs tracts I .navigation . ChannelConstraint, 
listener : 

20 org. atsc. abstractSI .util . SIRetrievalListener) : 

ChannelCollection 

This method returns a ChannelCollection object 
based on the grouping conditions specified in the 
filter parameter. If the filter is null, a collection 
25 of all known TvChannels is generated. 

This method can deliver results both synchronously 
or asynchronously. If requested data is available 
immediately, it is returned synchronously. 

If the data must be retrieved from the transport 
3 0 first, the SIDelayedDeliveryException 875 is thrown and 
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the results are delivered to the registered listener 
via an event. 

Parameter filter - A rule constraining the 
requested channel collection. 
5 Parameter listener - A listener which receives 

the delivery event when data are retrieved 
asynchronously. If an application does not provide a 
listener (null) , no asynchronous retrieval is 
attempted. The listener is registered for this one 
10 call only. 

setPref erredLanguage (language : int) : void 
This method sets the language used to return any 
textual information from the SI related classes and 
interfaces (e.g., TvChannel name, etc.) if provided as 
15 a multilingual string in multiple languages. If the 

specified language is not available, the system-level 
preferred language is used. If that language is not 
available either, the first available language will be 
used. 

2 0 This method is used to temporarily override the 

system-level preferred language within the abstractSI 
package . 

getPref erredLanguage () : int 

This method is called to determine the preferred 
25 language for returning string-type values. 
getRatingRegions () : int[] 

This method returns a list of available Rating 
Region IDs . 

retrieveRatingRegion (regionID : int, listener : 

3 0 org . a tsc . abs trac tSI . u til . S IRetrievalLis tener ) : 

RatingRegion 
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This method is used to obtain a RatingRegion 
object of the specified ratingRegionlD . This method 
may deliver data synchronously as well as 
asynchronously . 

5 2.1.4 ChannelConstraint 235 

This association class represents a set of rules 
or filtering criteria used to generate a particular 
ChannelCollection 220. Filtering used to create such a 
collection may be based on TS ID, Network ID, System 
10 Type (DVB, ATSC, etc.), Bouquet, content theme (e.g., 

sports), Channel name or a subset of it (e.g., CNN), 
etc . 

Public Operations: 

ChannelConstraint (filter : int, value : 
15 java.lang. Object) : 

This constructor specifies what the grouping 
criteria should be. 

Parameter filter - Filter represents an enumerated 
value of a specific filter type. 
20 Parameter value - Sets the filter value based on 

the filter type. 

getFilterType () : int 

Called to determine what grouping mechanism is 
used for this ChannelConstraint. 
25 getFilterValue () : java, lang. Object 

Called to determine the value of the current 
filter. The meaning of the value changes based on the 
filter type. 



2.1.5 CAIdentif ication 205 
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The CAIdentif ication interface provides a 
mechanism to associate CA-related information with any 
SI -related class, such as a TS or a TvChannel . It 
accesses information found in the CAT MPEG table. 
5 Public Operations: 

getCASystemlDs () : int[] 

Returns an array of CA System IDs as defined in 
the CAT MPEG message. Returns null if no CAT 
information is provided for this channel. 
10 isAccessControlled () : boolean 

Returns TRUE if this TvChannel is protected by CA. 
Returns FALSE if it is not protected or unknown. 

2.1.6 FilterType 265 

This interface provides a definition of constant 
15 values of supported filtering mechanisms, such as 

filtering by Network ID, TS ID, etc. 
Public Attributes: 
NETWORK_ID_FILTER : short = 1 

Filter based on Network ID 
20 TRANS PORT__ID_F ILTER : short = 2 

Filter based on TS ID 
BOUQUET_ID_FILTER : short = 3 

Filter based on Bouquet ID 
SYSTEM_TYPE_FILTER : short = 4 

25 Filter based on SI type (e.g., DVB, ATSC, etc.) 

S ATELL I TE_F ILTER : short = 5 

Filter based on Satellite ID 
TRANSPONDER_FILTER : short = 6 

Filter based on Transponder Number 
3 0 LOCATOR FILTER : short a 7 
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Filter based on a Locator (URL) 
CHANNEL_NAME_F I LTER : short = 8 

Filter based on channel names 
CHANNEL_NUMBER_FILTER : short = 9 

5 Filter based on channel numbers 

THEME_F I LTER : short = 10 

Filter based on themes/content categories 
FAVOR I TE__CHANNEL S_F ILTER : short = 11 

Filter based on user favorite channels 

10 2,1,7 TvChannelDe tails 245 

This interface provides access to TvChannel meta- 
data . 

Derived from DeliverySystemType 8 07, SlUpdate 83 0, 
Systemlnf ormationType 810, and CAIdentif ication 205. 
15 Public Operations: 

retrieveChannelDescription (listener : 
org . atsc . abs tractSI .util . SIRetrievalLis tener) : String 

Returns a textual description of this channel or 
null if none available. 
20 getServiceProvider () : String 

Returns the name of the service provider. 
getServiceType () : int 

Returns the type of this service. Service type is 
one of the following values: digital TV, digital radio, 
25 analog TV, analog radio, data service, ' NVOD reference 
service, NVOD time shifted service. This list may be 
extended with new types of services in the future. 

retrieveComponents (listener : 
org . atsc . abs tractSI .util . SIRetrievalLis tener) : 
3 0 ChaxmelComponen t [ ] 
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This method returns a list of elementary 
components which are part of this channel. 
getRunningStatus () : short 

Returns the running status of this service (see 
5 DVB SI documentation) . 

retrieveContentAdvisory (listener : 
org.atsc.abstractSI .util . SIRetrievalLis tener) : 
org ♦ atsc . abs tractSI . guide ♦ ContentRatingAdvisory [] 

Returns a list of Content Advisory information for 
10 each Rating Region. 

getDeliverySysteznType () : int 

Called to determine the mechanism of delivering 
this TvChannel (e.g., cable, satellite, etc). 

2.1.8 Channel Ident if ication 250 

15 This interface is used to provide a flexible and 

extensible way of identifying TvChannels by names, 
channel numbers , or other means . 

It can be extended to support specific mechanisms 
such as the ATSC two-part channel numbers. 
20 Public Operations: 

getChannelNumber () : String 

Returns a channel number, which is a .system- 
specific value. For example, DCII uses a single 
number, DVB does not really support channel numbers or 
25 they are set- top or broadcaster specific, and ATSC now 

has the two-part channel number. 

In the ATSC domain, it is in the major. minor 
notation (a string with a dot between the major and 
minor channel numbers) . 
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For DVB channels, it can be the service ID as the 
channel number . 

It can also represent a broadcaster-specific 
channel numbering mechanism delivered as a private 
5 descriptor. 

getChannelName () : String 

Returns a short channel name or an acronym. 
2.2 Guide Package (FIG. 3) 

This view of the SI is from the point of view of a 
10 program guide which shows not only the service 

availability but a list of future events offered on 
each of them. 



2.2.1 Programs chedule 320 

This interface represents a collection of program 
15 events for a given TvChannel 225 ordered by time. It 

provides the current, next and future events. 
Public Operations: 
retrievePresentEvent (listener : 

org.atsc .abstractSI .util « SIRetrievalListener) : 
20 ProgramEvent 

Returns the current (can be viewed if tuned to) 
program event . 

retrieveFollowingEvent (listener : 
org.atsc. abstractSI .util .SIRetrievalListener) : 
25 ProgramEvent 

Returns the program event which immediately 
follows the current program event. 

retrieveFutureEvent (when : java. util .Date, 
listener : 
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org.atsc.abstractSI .util . SIRetrievalListener) : 
ProgramEvent 

Returns the program event for the specified time. 
The program event which contains the specified time 
5 will be returned. The specified time falls between the 

program event ! s start time and the start time plus the 
event ! s duration . 

Null is returned when the specified time does not 
fall inside any known program event. 
10 retrieveFutureEvents ( s tar tOf Interval : 

java.util .Date, endOf Interval : java .util .Date, 
listener : 

org . atsc . abs tractSI .util .SIRetrievalListener) : 
ProgramEvent [] 

15 Returns all known program events on this channel 

for the specified time interval. 

retrieveEvent (locator : org.davic.net .Locator, 
listener : 

org.atsc.abstractSI .util . SIRetrievalListener) : 
2 0 org . a tsc . abs tractSI . guide . ProgramEvent 

This method retrieves a program event matching the 
locator. Note that the event must be part of this 
schedule . 

addLis tener (listener : 
25 org.atsc.abstractSI .util . SIChangeLis tener) : void 

Called to register an SIChangeListener 815 for 
events related to changes of the ProgramEvents 340 on 
this schedule. The ProgramChangeEvent 845 is delivered 
to the specified listener when any ProgramEvent on this 
30 schedule changes. 
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removeListener (listener : SIChangeListener) : 

void 

Called to deregister a SIChangeListener 815. 

2.2.2 ProgramEvent 340 

5 This interface comprises a collection of 

elementary streams with a common time base, an 
associated start time, and an associated end time. An 
event is equivalent to the common industry usage of "TV 
program. " 

10 The Event Information Table (EIT) contains 

information (titles, start times, etc.) for events on 
defined TvChannels. An event is, in most cases, a 
typical TV program, however its definition may be 
extended to include particular data broadcasting 

15 sessions and other information segments, such as an 

infomercial, or to show that part of the event includes 
an interactive data application and the other part does 
not . 

Derived from Systemlnf ormationType 810 and 
20 SlUpdate 830. SlUpdate is an interface which is shared 

by all SI objects which represent SI tables and it 
provides information about the last time this object 
was updated. 

Public Operations: 
25 getLocator () : Locator 

Returns a Locator representing this program event, 
gets tar tTime () : java.u til .Date 

Returns the start time of this program event. 
getEndTime () : java.util .Date 

30 Returns the end time of this program event. 
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getDuration () : long 

Returns the duration of this program event in 
seconds . 

getEventName () : String 

5 Returns the program event title* 

retrieveDescription (listener : 
org.atsc.abstractSI.util . SIRetrievalListener) ; String 

Returns a textual description of the event. This 
information comes from the Extended Text Table (ETT) in 
10 ATSC or an Extended Event Descriptor in DVB. An empty 

string will be returned when no ETT is available for 
this event . 

retrieveContentAdvisory (listener : 

org.atsc.abstractSI.util .SIRetrievalListener) : 
15 ContentRatingAdvisory [] 

Returns a list of Content Advisory information for 
each Rating Region. 

getRunningStatus () : short 

Returns the running status of this event (see DVB 
2 0 SI documentation) . 

getTvChannel () : TvChannel 

Returns the TvChannel this program event is 
associated with. In DVB, events and TvChannels are 
associated via the service ID; in ATSC, they are 
25 associated via the source ID. 

getCost () : String 

This method returns the cost of an IPPV Program 
Event or null if this is not an IPPV event, 
getTheme () : short [] 

30 This method returns a list of themes associated 

with the program. It is represented as a number and is 



system-specific (e.g., DVB content nibble). Refer to 
the appropriate specification for details. 

2.2.3 ContentRatingAdvisory 310 

The Content Advisory is used to indicate, for a 
given event, ratings for any or all of the rating 
dimensions defined for each rating region. Ratings may 
be given for any or all of the defined regions . An 
Event without content advisory indicates that the 
rating value for any rating dimension defined in any 
rating region is zero. The absence of ratings for a 
specific dimension is completely equivalent to having a 
zero-valued rating for such a dimension. The absence 
of ratings for a specific region implies the absence of 
ratings for all the dimensions in the region. 

Public Operations: 

getRatingRegion () : short 

Returns a unsigned 8 -bit integer that specifies 
the rating region for which the data in this object is 
defined. The rating_region associates ratings data 
given here with data defined in a RRT tagged with the 
corresponding rating region. 

Note that the DVB rating system is based on age 
only. It can be easily mapped to this more elaborate 
rating system as one of the dimensions. 

getD intensions () : short [] 

Returns a list of all dimensions rated for this 
Rating Region. 

getRatingValue (ratedDimension : short) : short 
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Returns a number representing the rating value of 
the dimension specified by the parameter for this 
rating region. 

getRatingText (ratedDimension : short) : String 

5 Returns the rating description display string for 

the specified dimension. It shall be limited to 16 
characters or less. 



2.2.4 RatingRegion 330 

This interface defines all rating dimensions of a 
10 specific rating region. 

PSIP Rating defines the TV parental guideline 
system referenced by any content advisory descriptor 
for a Service or Event. It is based on the RRT. 
Public Operations: 
15 getNumberOfDimensions () : short 

Returns the number of rating dimensions defined in 
this Rating Region. 

getRegionName () : String 

Returns the rating region name, e.g., "U.S. (50 
20 states + possessions)", associated with the Rating 

Region. The display string for the rating region name 
shall be limited to 32 characters or less." 

getRatingDimensions () : RatingD intension [] 

Returns an array of all Rating Dimensions defined 
25 for this Rating Region. 



2.2.5 RatingDimension 350 

One dimension in the U.S. rating region, for 
example, is used to describe the MPAA list. The 
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dimension name for such a case may be defined as 
"MPAA" . 

Another example of a rating dimension may be a 
age-based DVB rating. 
5 Public Operations: 

getDimensionName () : String 

Returns a string which represents the dimension 

name being described by this object, such as "MPAA". 

The dimension name display string shall be limited to 

10 20 characters or less. 

isGraduatedScale () : boolean 

Indicates whether or not the rating values in this 
dimension represent a graduated scale, i.e., higher 
rating values represent increasing levels of rated 
15 content within the dimension. Value 1 means yes, while 

value 0 means no . 

getNumberOf Levels () : short 

Returns 4-bit field (1-15) specifying the number 
of values defined for this particular dimension. 
2 0 getRatingLevelDescription (ratingLevel Index : 

short) : String [] 

Returns a pair of Strings describing the specified 
Rating Level for this Dimension. 

The first string represents the abbreviated name 
25 for one particular rating value. The abbreviated name 

for rating value 0 shall be set to a null string, i.e., 
" The abbreviated value display string shall be 
limited to 8 characters or less. 

The second string represents the full name for one 
30 particular rating value. The full name for rating 

value 0 shall be set to a null string, i.e., 11 " . The 
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rating value display string shall be limited to 150 
characters or less. 

2.2.6 TvChannelWithSchedule 300 
This interface extends the TvChannelDetails by 
5 adding access to the program schedule associated with 
this TvChannel. It is derived from TvChannelDetails 
245. 

Public Operations: 

getProgramSchedule () : ProgramSchedule 

10 Returns a schedule of programs/events associated 

with this TvChannel. 

2.3 Selection Package (FIG. 4) 

This view at the SI is from the point of view of 
channel selection. It represents the information that 
15 is necessary to provide to other APIs, such as 

Networklnterf aceController, JMF Player, A/V Decoder, 
etc., to select, tune and eventually decode a specific 
MPEG-2 service and its components. 

2.3.1 ChannelComponent 410 

20 This interface represents an abstraction of an 

MPEG Elementary Stream. It provides information about 
individual components of the TvChannel . 225 . It may be 
used by a Player to select the appropriate components 
of the TS. 

25 Public Operations: 

getComponentName () : String 

Returns a name associated with this component. 
The Component Descriptor may be used if present. A 
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generic name (e.g., video, first audio, etc.) may be 
used otherwise. 

getAssociatedLanguage () : int 

Returns 3 -byte (24 bits) field, based on ISO 
5 639. 2/B, specifies the language used for the elementary 

stream. In case of no language specified for this 
elementary stream, e.g., video, each byte shall have 
the value 0x00 . 

getStreamType ( ) : short 

10 Returns the stream type of this component. 

See also StreamType 

2.3.2 MPEGLocator 440 
Derived from Locator 43 0. 
Public Operations: 

15 getNetworkID () : int 

Called to determine the Network ID of the network 
this Locator represents. 

getServicelD () : int 

Called to determine the Service ID (MPEG program 
20 number) of the service this Locator represents. 
getTransportStreamID () : int 

Called to determine the TransportStreamID of the 
transport this locator represents. 
getEventID () : int 

25 Returns an identification of this program event. 

Note: ATSC PSIP Event ID is unique only within a 
single EIT table while the DVB Event ID is unique 
within the service. 

2.3.3 ATSCLocator 450 
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Derived from MPEGLocator 440. 

Public Operations: 
getSourcelD () : int 

Returns an integer number that identifies the 
5 programming source associated with the virtual channel . 

In this context, a source is one specific source of 
video, text, data, or audio programming. 

Source ID value zero is reserved. Source ID 
values in the range 0x0001 to OxOFFF shall be unique 
10 within the TS that carries the VCT, while values 0x1000 

to OxFFFF shall be unique at the regional level . 

Values for source_ids 0x10 0 0 and above shall be 
issued and administered by a Registration Authority 
designated by the_ATSC. 

15 2.3.4 MPEGChannelComponent 420 

This is a specific Channel Component representing 
MPEG- 2 elementary stream. 

Derived from Channel Component 410. 
Public Operations; 

20 getPID () : short 

Returns the PID the data of elementary stream is 
sent on in the TS . 

getPcrPID () : short 

Returns the PCR PID number associated with this 
25 component. 

getTag () : int 

Returns the component tag (Stream Identifier 
Descriptor) of this elementary stream, or null if none 
is present. 
3 0 getAssociationTag 0 : int 
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Returns the association tag (Association Tag 
Descriptor) of this elementary stream, or null if none 
is present. 



2.3.5 Tunable Channel Control (415) 

5 Tunable Channel Control is an interface which 

accepts a TvChannel object that can be tuned to and 

played by the JMF Player or its DTV derivative. 

% Derived from JMF j avax. media . Control . 

ri Public Operations: 

3 10 getCurrentChannel ( ) : TvChannel 

,1 Returns the currently-playing TvChannel. 

n play (newChannel : TvChannel) 

,9 * This method is called to initiate a tuning, 

;g decoding and presentation of a TvChannel . 

t 15 play (newChannel : TvChannel/ components : int[]) 

^ This method is called to initiate a tuning, 

3 decoding and presentation of a TvChannel. The 

additional parameter specifies which components of the 
TvChannel to play. Components are identified by their 
20 tag number. 

play (newChannel : TvChannel, language : int) 

This method is called to initiate a tuning, 
decoding and presentation of a TvChannel. The 
additional parameter specifies which components of the 
25 TvChannel to play based on the language association. 



2.4 Descriptor Package (FIG . 5) 

This package describes a general API mechanism of 
retrieving descriptors from any type of an MPEG table: 
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MPEG PSI, DVB SI, ATSC PSIP, or even private tables 
such as DCII . 

The intention is to define an SI -format- 
independent mechanism of retrieving these descriptors 
5 to minimize the knowledge of DVB and ATSC differences 

and the need for special code in an application calling 
this API ♦ 

Refer to the discussion in section 1.4, 
"Descriptor View" . 

10 2.4.1 MPEGTableDescriptors 540 

This interface provides a mechanism for retrieving 
MPEG Descriptors associated with any MPEG, DVB, ATSC or 
even a private table. It either returns a set of 
descriptors or a set of available descriptor tags . The 

15 calling application may also hint which descriptors it 

is interested in. Only a subset of those will be 
returned if they exist in the specified table. 

Descriptors are primarily identified by a URL. 
This is in many cases not enough because a service, for 

20 instance, may be described in multiple tables, such as 

PMT and SDT. Therefore, table type is specified to 
identify which type of a table to retrieve* descriptors 
from. In some rare cases an additional identification 
is needed. For instance, if a RRT type is specified, a 

25 Rating Region ID is needed to retrieve the proper 

subset of descriptors. The same applies to BAT type 
tables, where a Bouquet ID is needed to determine which 
descriptors to retrieve. 
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Additionally, an optional set of descriptor tags 
can be specified in the call to limit the search and 
the returned set of descriptors. 

Derived from DescriptorTag 520 and TableType 510. 
5 Public Operations: 

retrieveDescriptors (url : Locator, tableType : 
short, someTags : short [], listener : 
org.atsc.abstractSI.util . SIRetrievalListener) : 
org . atsc . abstractSI • descriptor .Descriptor [] 
0 Retrieves a set of descriptors. This method 

retrieves all or a set of descriptors associated with 
the entity specified by the Locator (URL) delivered in 
the specified table in the order the descriptors are 
broadcast . 

5 Parameter url - A URL-based specification of an 

entity (such as a TS, a service, etc.) for which to get 
the descriptors . 

Parameter tablelD - A TableType of the table from 
which to retrieve the specified descriptors. 

0 Parameter someTags - A list of tags for 

descriptors (identified by their tags) the application 
is interested in. All non- applicable tag values are 
ignored. If this list is empty or null, all 
descriptors will be returned. 

5 Parameter listener - A listener which receives the 

delivery event when data are retrieved asynchronously. 
If an application does not provide a listener (null) , 
no asynchronous retrieval is attempted. The listener 
is registered for this one call only. 

0 Return Value - A set (or subset) of Descriptor 

objects as indicated in someTags. 
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See also Descriptor. 

retrieveDescriptors (url : Locator, tableType : 
short, entity ID : short, someTags : short [], listener : 
org . atsc . abs tractSI . util ♦ SIRetrievalLis tener) : 
org , atsc . abs tractSI . descriptor .Descriptor [] 

Retrieves a set of descriptors. This method 
retrieves all or a set of descriptors associated with 
the entity specified by the Locator (URL) delivered in 
the specified table in the order the descriptors are 
broadcast . 

Parameter url - see previous definition. 

Parameter tablelD - see previous definition. 

Parameter entitylD - An ID representing a specific 
entity described in the specified table. The entity 
type depends on the table type. For example , if the* 
table ID identifies an BAT, then the entity ID is a 
specific Bouquet ID. 

Parameter someTags - see previous definition. 

Parameter listener - see previous definition. 

Return Value - see previous definition. 

See also Descriptor. 

retrieveDescriptorTags (url : Locator, tableType : 
short, listener : 

org. atsc. abs tractSI. util .SIRetrievalLis tener) : short [] 

Retrieves the tags of all descriptors associated 
with the entity specified by the Locator (URL) that are 
actually broadcast for the specified table type. The 
tags are returned in the same order as the descriptors 
are broadcast (i.e., in the transport stream). 

Parameter url - see previous definition. 
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Parameter table ID - A Table ID of the table from 
which to retrieve the descriptor tags. 

Parameter listener - see previous definition. 

Return Value - The tags of the descriptors 
5 actually broadcast for the specified table (identified 
by their tags) . 

See also DescriptorTag. 

retrieveDescriptorTags (url : Locator, tableType : 
short, entity ID : short, listener : 
10 org.atsc.abstractSI.util.SIRetrievalListener) : short [] 

Retrieves the tags of all descriptors associated 
with the entity specified by the Locator (URL) that are 
actually broadcast for the specified table type. The 
tags are returned in the same order as the descriptors 
15 are broadcast. 

Parameter url - see previous definition. 

Parameter tablelD - see previous definition. 

Parameter entitylD - An ID representing a specific 
entity described in the specified table. The entity 
2 0 type depends on the table type. For example, if the 

table ID identifies a BAT, then the entity ID is a 
specific Bouquet ID. 

Parameter listener - see previous definition. 

Return Value - see previous definition. 
25 See also DescriptorTag. 

2.4.2 Descriptor 530 

This interface specifies the basic structure of an 
MPEG Descriptor. It consists of a Tag, Length and a 
array of bytes. 
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Derived from Systemlnf ormationType 810 and 
DescriptorTag 520. 

Public Operations: 
getTag () : short 

Returns the descriptor tag. 
getByteAt (index : ixit) : byte 

Returns a particular byte within the descriptor 

content . 

getLengtli () : short 

Returns the length of the descriptor content. 
getContent () : byte[] 

Returns the whole descriptor content . 
2.4.3 DescriptorTag 520 

This interface defines constants corresponding t 
the most common descriptor tags. See also Descriptor 
Public Attributes: 
NETWORK_NAME : short = 0x40 
SERVICE_LIST : short = 0x41 
STUFFING : short = 0x42 

SATELLITE_DELIVERY_SYSTEM : short = 0x43 

CABLE_DELIVERY_SYSTEM : short = 0x44 

BOUQUET_NAME : short = 0x47 

SERVICE : short » 0x48 

COUNTRY_AVAILABILITY : short = 0x49 

LINKAGE : short = 0x4A 

NVODJREFERENCE : short = 0x4B 

T IME_SHI FTED_S ERVI CE : short = 0x4 C 

SHORT_EVENT : short = 0x4D 

EXTENDED_EVENT : short = 0x4E 

TIME SHIFTED EVENT : short = 0x4F 



COMPONENT : short = 0x50 
MOSAIC : short = 0x51 
STREAM_IDENTIFIER : short = 0x52 
CA_IDENTIFIER : short = 0x53 
CONTENT : short = 0x54 
PARENT AL_RAT ING : short = 0x55 
TELETEXT : short = 0x56 
TELEPHONE : short = 0x57 
LOCAL_TIME_OFFSET : short = 0x58 
SUBTITLING : short = 0x59 

TERRESTRIAL_DELIVERY_SYSTEM : short = 0x5A 
MULTILINGUAL_NETWORK_NAME : short = 0x5B 
MULTILINGUAL_BOUQUET_NAME : short = 0x5C 
MULTIL INGUAL_S ERVI CE_NAME : short = 0x5D 
MULTIL INGTJAL_COMPONENT : short = 0x5E 
PRIVATE_DATA_SPECIFIER : short = 0x5F 
SERVICE_MOVE : short = 0x60 
SHORT_SMOOTHING_BUFFER : short = 0x61 
FREQUENC Y_L 1ST : short = 0x62 
PARTIAL_TRANSPORT_STREAM : short = 0x63 
DATA_BROADCAST : short = 0x64 
AC3_AUDIO : short = 0x81 
PROGRAM_IDENTIFIER : short = 0x85 
CAPTIONJSERVICE : short = 0x86 
CONTENT_ADVISORY : short = 0x87 
EXTEND ED_CHANNEL_NAME : short = OxAO 
SERVICE_LOCATION : short = OxAl 
TIME_SHIFTED_ATSC_SERVICE : short = 0xA2 
COMPONENT_NAME : short = 0xA3 

2.4.4 TableType 510 
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This interface defines a set of constants 
corresponding to MPEG, ATSC and DVB table types, or 
private tables such as DCII. 
Public Attributes: 
5 UNKNOWN : short = 0 

CA_INFO : short = 1 

MPEG PS I CAT table. 
SERVICE_INFO : short = 2 

MPEG PS I PMT table. 
10 TRANSPORT_INFO : short = 3 

MPEG PS I TSDT table. 

NA V I GAT I ON_ INF 0 : short = 4 

DVB BAT and SDT tables, and ATSC VCT table. 
NET_INFO : short = 5 

15 DVB NIT table and ATSC MGT table. 

RATING_INFO : short = 6 

ATSC RRT table. 
TIME_INFO : short = 7 

DVB TOT table and ATSC STT table. 
2 0 EVENT_INFO : short = 8 

DVB EIT table and ATSC EIT table. 
2.5 Pipeline Package (FIG. 6) 

This package represents the pipeline (or network) 
view. It represents objects related to the transport 
25 delivery mechanism such as MPEG- 2 . It could also 

include information about non-MPEG delivery protocols 
such as IP . 



2.5.1 



Satellitelnf ormation 605 
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This interface represents information about 

Satellites in a satellite delivery network. 

Public Operations: 
getSatellitelD () : int 

5 Returns the ID of this Satellite. 

getSatelliteName () : String 

Returns the full Satellite name. 
getSatelliteAbbreviation () : String 

Returns the abbreviated satellite name. 
10 getNumberOf Transponders () : int 

Returns the number of Transponders available on 
this Satellite. 

getTransponderNumbers () : int [3 

This method returns an array of transponder 
15 numbers available on this Satellite. 

getTransponderName ( tranponderNumber : int) : 
String 

Returns the name of the specified Transponder. 
getTranponderNumber ( transports treamID : int) : 

2 0 int 

Returns the transponder number that delivered the 
specified TS. 

2.5.2 Bouquet Information 63 0 

This interface represents information about a 
25 bouquet (a collection of services which can span TS and 
network boundaries), which is a DVB- specific concept. 
Public Operations: 
getBouquetID () : int 

This method returns the ID of this Bouquet 
30 definition. 
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getName () : java. lang. String 

This method returns the name of this Bouquet. 



2.5.3 TransportStreamlnf o 660 

This interface provides information about a TS . 
Derived from Systemlnf ormationType 810. 
Public Operations: 

getLocator () : org .davic.net, Locator 

This method returns the URL of this TS . 
getNetworkID () : int 

Returns the ID of the Network which carries this 

TS. 

getTransportStreamlD ( ) : int 

This method returns the ID of this TS . 
getDescription () : String 

Returns a textual name or a description of this 

TS. 

getOriginalNetworkID () : int 

This method returns the Network ID of the Network 
where this TS originated from. 

This method returns the same ID as getNetworkID if 
this TS originated on the Network that carries it. 

2.5.4 Networklnf ormation 

This interface provides descriptive information 

about a Network of Transport Streams . 

Public Operations: 
getNetworkID () : int 

This method returns the ID of this Network 
getLocator () : org.davic.net .Locator 

This method returns the URL of this Network. 
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getNetworkName () : java. lang. String 

This method returns the name of this network. 

2.5.5 MPEGPipeline 670 

The MPEG SI Manager represents MPEG-2 specific SI. 
5 Derived from Pipelinelnf ormation 650 and 

MPEGTableDescriptors 540. 
Public Operations: 

retrieveSatelli telnf ormation ( tranportStreamID : 
int, listener : 
10 org. atsc. abs tractSI .util . SIRetrievalListener) : 

Satellitelnf ormation [] 

This method returns an array of object 
representing information about the Satellites carrying 
the specified Transport Stream. 
15 If no TS is specified, it returns an array of 

objects representing information about all known 
Satellites . 

It returns an empty array if this is not a 
satellite network. 
20 retrieveBouquet (bouquetID : int, listener : 

org. atsc. abs tractSI. util .SIRetrievalListener) : 
org . atsc . abs tractSI .pipeline . Bouquetlnf ormation 

This method returns information about the 
specified Bouquet. 
25 retrieveBouquets (listener : 

org. atsc. abs tractSI .util . SIRetrievalListener) : 
Bouquetlnf ormation [] 

Returns an array of Bouquetlnf ormation objects 
representing all known Bouquets. 
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re trieveTransport Stream (url : Locator, listener : 
org. atsc.abstractSI .util .SIRetrievalListener) : 
Transports treamlnf o 

The method returns a specific TransportStreamlnf o 
5 object representing information about the specified TS . 

retrieveTransportStreams (networkID : int, 
listener : 

org.atsc . abstractSI .util .SIRetrievalListener) : 
TransportStreamlnf o [] 

10 Returns an array of TransportStreamlnf o objects 

representing all known Transport streams for the 
specified network. 

retrieveNetwork (networkID : int, listener : 
org.atsc. abstractSI .util . SIRetrievalListener) : 
15 Networklnf ormation 

Returns the Networklnf ormation specified by its 

ID, 

retrieveNetworks (listener : 
org . atsc . abs tractSI . util . SIRetrievalListener) : 

2 0 Networklnf ormation [ ] 

Returns an array of Networklnf ormation objects 
representing all known networks. 

addListener (listener : SIChangeListener) : void 

Called to register a SIChangeListener 815 for 
25 changes related to changes in objects provided by the 

SIManager 240. 

This includes TransportStreamlnf o 660, 
Networklnf ormation 610, etc. but excludes TvChannel 225 
and ProgramEvent 340 which can be listened to via the 

3 0 appropriate collections, such as the ChannelCollection 

220 and Programs chedule 320. Therefore, the 
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Sllnf oChangeEvent 850 will be delivered to the 
listener . 

removeListener (listener : SIChangeListener) : 

void 

5 Called to deregister a SIChangeListener 815. 

2.5*6 SISpecif icManager 640 

This SI manager has specific information about the 
content delivery media. Derived from SIManager 240. 

Public Operations : 
10 getPipelinelnf o () : 

org . atsc . abs tractSI .pipeline . Pipelinelnf ormation [] 

This method returns a list of objects representing 
different content delivery media, such as MPEG-2 
transport . 



15 2.5.7 Pipelinelnf ormation 650 

This abstract class is a placeholder for different 
content delivery media. It must be extended by an 
object that is specific to a particular transport 
mechanism, such as MPEG-2 TS . 



20 2.6 Data Package (FIG. 7) 

This package represents a schedule of data events. 
Similar to audio/video programs, there, may also be data 
events scheduled for a given TvChannel . 



25 



2.6.1 TvChannelWithData 710 

This interface extends the TvChannelDe tails by 
adding access to the data event schedule associated 
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with this TvChannel. Derived from TvChannelDe tails 
245. 

Public Operations: 
getDataSchedule () : 
5 org . atsc . abs tractSI . data . DataSchedule 

This method returns a schedule of data events. 



2.6.2 DataSchedule 720 

This interface represents a collection of data 
events for a given TvChannel ordered by time. 
10 Public Operations: 

addListener (listener : 

org. atsc. abstractSI .util.SIChangeListener) : void 

Called to register an SIChangeListener 815 for 
events related to changes of the DataEvents 73 0 on this 
15 schedule. The DataChangeEvent 840 is delivered to the 

specified listener when any DataEvent 730 on this 
s chedul e change s . 

removeLis tener (listener : 
org . atsc . abstractSI . util . SIChangeListener) : void 

20 Called to deregister a SIChangeListener. 

retrieveEvent (when : java. util. Date, listener : 
org . atsc . abstractSI . util . SIRetrievalLis tener) : 
org . atsc . abstractSI . data . DataEvent 

Returns the data event for the specified time. 
25 The data event which contains the specified time will 

be returned. The specified time falls between the data 
event 1 s start time and the start time plus the event's 
duration. 

Null is returned when the specified time does not 
3 0 fall inside any known data event. 
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retrieveEvents (startOf Interval : java. util. Date, 
endOflnterval : java. util. Date, listener : 
org . atsc . abs tractSI . util . SIRetrievalLis tener) : 
org . atsc . abs tractSI . data . DataEvent [] 

5 Returns all known data events on this channel for 

the specified time interval. 

retrieveEvent (locator : org .davic .net .Locator, 
listener : 

org. atsc. abstractSI. util . SIRetrievalListener) : 
10 DataEvent 

This method retrieves a data event matching the 
locator. The event must be part of this schedule. 

2.6.3 DataEvent 73 0 

This object represents a data event associated 
15 with a TvChannel 225 for a particular time interval. 

In ATSC, the information is delivered in DIT tables. 
D1T is an extension of PSIP. It is similar to the 
EITs, but it announces data events (not audio-visual 
events) and is defined in the ATSC T3/S13 Data 
20 Broadcast Specification. 

Derived from SlUpdate 830. 
Public Operations: 

getLocator () : org. davic. net. Locator 

Returns a Locator representing this data event. 
25 getStartTime () : java .util .Date 

Retuns the start time of this data event. 
getEndTime () : java .util .Date 

Retuns the end time of this data event. 
getDuration () : long 
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Returns the duration of this data event in 
seconds . 

getTitle () : java. lang. String 

Returns the data event title, 
5 retrieveDescription (listener : 

org.atsc.abstractSI .util .SIRetrievalListener) : 
j ava • lang . S tr ing 

Returns a textual description of the event. This 
information comes from the ETT in ATSC, or an Extended 
10 Event Descriptor in DVB. An empty string will be 
returned when no ETT is available for this event. 
retrieveContentAdvisory (listener : 

org. atsc. abstractSI .util.SIRetrievalListener) : 
org . atsc . abs tractSI . guide . ContentRatingAdvisory 

15 Returns a list of Content Advisory information for 

each Rating Region. 

getTvChannel ( ) : 
org . atsc . abs tractSI . navigation . TvChannel 

Returns the TvChannel this data event is 
20 associated with. In DVB, events and TvChannels are 

associated via the service ID; in ATSC, they are 
associated via the source ID. 

2.7 Utility Package (FIG. 8) 

This package defines classes and interfaces that 
25 provide support functions to the SI packages. This 
includes the notification mechanism (events and 
listeners) , the Factory Method for creating the 
SIManager object, and all Exceptions. 
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The Factory Method is a methodology and structure 
for solving a problem, as known from the field of 
object-oriented programming. 



2.7.1 SIFactory 805 

5 This class provides a mechanism to create objects 

that implement the SIManager interface 240. This class 
is modeled after the Factory Method design pattern. 

Public Operations: 

SIFactory () : 

10 Constructor 

getSIManager () : SIManager 

Returns an implementation of the SIManager 
interface or null if not available. 



2.7.2 SIChangeListener 815 

15 The SIChangeListener interface shall be 

implemented by using application classes to listen to 
changes in SI objects. It provides a method to be 
called back by the listened to SI object to notify of 
an event. 
20 Public Operations: 

SIChange (event : SIChangeEvent) : void 

This method gets called when an existing SI object 
is changed, a new SI object is detected or an existing 
SI object is no longer available. 



25 2.7.3 SIChangeEvent 834 

SIChangeEvent objects 834 are sent to 
SIChangeListeners 815 to notify of a new event. 
Derived from EventObject 820. 
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Public Operations: 
getType () : byte 

Returns the event type (the possible values are 
defined in the SIChangeEvent Type interface) . 

5 2.7.4 S IChangeEventType 

This interface defines the constants corresponding 
to the SIChangeEvent type values. 
Public Attributes: 
0BJECT_CHA2TGED : byte = 1 

10 An existing object has changed. 

NEWJDBJECT : byte = 2 

New object detected. 
0BJECT_DNKN0WN : byte = 3 

Object no longer available. 

15 2.7.5 TvChannelChangeEvent 835 

This event delivers information about a particular 
TvChannel. Derived from SIChangeEvent 834. 
Public Operations: 
getChangedChannel () : Locator 

2 0 This method is called to determine which channel 

has changed . 

2.7.6 ProgramChangeEvent 845 

This event delivers information about a particular 
ProgramEvent . 
25 Derived from SIChangeEvent 834. 

Public Operations: 
getChangedProgram () : Locator 
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This method is called to determine which 
ProgramEvent has changed. 

2.7.7 SI Inf oChangeEvent 850 

This event delivers information about a particular 
5 high-level SI object usually obtained via the SI 
Manager. Derived from SIChangeEvent 834. 
Public Operations: 
getSIObjectType () : short 

This method is called to determine which type of 
10 an SI object has changed. This may be 

TransportStreamlnf o 660, Networklnf ormation 610; 
Bouquetlnf ormation 630, RatingRegion 330, etc. 

getSIObjectID () : int 

This method returns the ID of the changed SI 
15 object whose type is identified by the getSIObjectType 

method. For example, if the SIObjectType is 
TransportStreamlnf o, then the SIObjectID will be the TS 
ID. 

2.7.8 SlUpdate 83 0 

20 This interface can be associated with any SI 

entity. It provides information about when the data 
was last updated. The SI database may have new 
information which all listeners get notified about. 
Public Operations: 

25 getUpdateTime () : java.util .Date 

Return the time when the information contained in 
the object that implements this interface was last 
updated. 

Return Value - The date of the last update. 
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2.7.9 SIDelayedDeliveryException 875 

This exception is thrown when requested data is 
not available immediately (e.g., not cached) and 
signals an asynchronous delivery of the data. 
5 Derived from Exception 860. 

Public Operations: 

getRequest () : org.atsc.abstractSI.util.SIRequest 

This method returns an object representing the 
asynchronous request. It can be used to cancel the 
10 request and to associate it with the event delivering 

the requested data. 

2.7.10 SIRetrievalListener 870 

This interface shall be implemented by application 
classes to receive events about completion of 
15 asynchronous SI requests. 

In general, the listener registers itself at the 
time of the potentially asynchronous call (as one of 
the parameters) . The listener is registered for one 
call only and is automatically deregistered when the 
20 request is satisfied. 

Public Operations: 
postRetrievalEvent (event : 
org . atsc . abstractSI . util . SIRetrievalEvent) : void 

This method is called to deliver an asynchronous 
25 SI retrieval event to the listener. 

2.7.11 SIRetrievalEvent 865 

This event delivers data requested asynchronously 
by any of the "retrieveXXX" calls. All the methods 
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which start with the word "retrieve" fall into this 
category, e.g., retrieveDetails ( ) in block 225, 
retrievePresentEvent () in block 320, etc. 

It either delivers the data itself or an 
5 indication of a failure. It also provides mechanism 

to associate this event with the original request using 
the request sequence number. 

This event is delivered only when the 
"retrieveXXX" call throws the SIDelayedDelivery 
10 exception 875, which contains the SIRequest object 886 

with the request sequence number. 

Derived from EventObject 820. 

Public Operations: 

getSequenceNumber () : int 

15 This method returns the sequence number assigned 

to the original asynchronous retrieval request to which 
this event is responding, 

2.7.12 SIRequest 886 

This object is used to facilitate asynchronous 
20 retrieval of SI data. This object can be used to 

cancel a pending request and to associate the request 
with a event delivering the requested data. 
Public Operations : 
cancelRequest () : boolean 

25 This method will cancel a pending request. 

Return Value ! True' indicates a successful 
cancellation of this request. 1 False 1 indicates that 
the request has already been delivered and cannot be 
cancelled. 

30 getSequenceNumber 0 : int 
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This method returns a number associated with this 
asynchronous retrieval call. It can be used to pair the 
subsequent event with this request. 

2.7.13 SIRetrievalSuccessEvent 884 
5 This event signals that the requested data has 

been retrieved and delivered. 

Derived from SIRetrievalEvent 865. 



2.7.14 SIRetrievalSingleSuccessEvent 892 
The event delivers a single object that was 

10 requested. Derived from SIRetrievalSuccessEvent 884. 

Public Operations: 
getResult () : java. laag. Object 

This method is used to obtain the data delivered 
by this event. 

15 The specific type (class) of the returned object 

can be anticipated from the context of the original 
call: it is the same object that would be retutned by 
the "retrieveXXX" method synchronously. 

2.7.15 SIRetrievalMultipleSuccessEvent 894 
20 The event delivers a array of objects that were 

requested. Derived from SIRetrievalSuccessEvent 884. 
Public Operations: 
getResult {) : java. laag. Object [] 

This method is used to obtain the data delivered 
25 by this event. 

The specific type (class) of the returned objects 
can be anticipated from the context of the original 
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call: it is the same object that would be returned by 
the "retrieveXXX" method synchronously. 

2.7.16 SIRetrievalFailEvent 882 

This event signals a failure to deliver the 
5 requested data. Possible reasons for a failure might 
be that the data is not present in the TS or resources 
were not available to obtain the data. 

Derived from SIRetrievalEvent 865. 

2.7.17 SIException 880 

10 This is a generic exception which can be thrown 

when a particular Si-related call contains invalid 
parameters. Derived from Exception 860. 

2.7.18 Systemlnf ormationType 810 

This interface provides access to specific SI 
15 databases (e.g., DVB SI database, ATSC PSIP database, 

etc . ) 

Public Attributes: 
ATSC_PSIP : short = 1 
DVBJSI : short = 2 
20 SCTE_SI : short = 3 

Public Operations: 

getSystemlnf ormationType () : short 

Called to determine the specific SI format this 
element was delivered in (e.g., ATSC PSIP, DVB SI, 
25 etc. ) . 



2.7.19 Da t aChangeE vent 840 
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This event delivers information about a particular 
data event. Derived from SIChangeEvent 834. 
Public Operations: 

getChangedData () : org. davic. net .Locator 



5 2.7.20 SINotAvailableException 890 

The exception indicates that the requested data is 
not available for the particular instance. 
Derived from SIException 880. 

10 2.7.21 DeliverySystemType 807 

This interface provides information about the 
delivery system type (e.g., cable, satellite, etc.) of 
the particular object implementing this interface. 
Public Attributes: 
15 CABLE_DELIVERY_SYSTEM : short = 1 

S ATELL I TE_D EL I VER Y_S YS TEM : short = 2 
TERRESTRIAL DELIVERY SYSTEM : short = 3 



Accordingly, it can be seen that the present 
20 invention provides an API that allows applications at a 

digital television terminal to recover SI from a 
digital TS without regard to the specific format type. 
The API abstracts the relevant portions of the SI to 
provide it in a format that is usable by the terminal. 
25 The system is suitable for use, e.g., with SI 

formats including MPEG PSI, DVB SI, and ATSC PSIP, and 
private SI. 

Although the invention has been described in 
connection with various specific embodiments, those 
30 skilled in the art will appreciate that numerous 
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adaptations and modifications may be made thereto 
without departing from the spirit and scope of the 
invention as set forth in the claims . 

For example, while various syntax elements have 
5 been discussed herein, note that they are examples 
only, and any syntax may be used. 

Moreover, the invention is suitable for use with 
virtually any type of network, including cable or 
satellite television broadband communication networks, 
10 local area networks (LANs) , metropolitan area networks 

(MANs) , wide area networks (WANs) , internets, 
intranets, and the Internet, or combinations thereof. 

Additionally, known computer hardware, firmware 
and/or software techniques may be used to implement the 
15 invention. 



